Skip to content

docs(v3-languages): promote to GA, deprecate v2/languages and v2/glossary-language-pairs#334

Closed
daniel-jones-dev wants to merge 1 commit intov3-langs/ga-cross-referencesfrom
v3-langs/ga-phase-2
Closed

docs(v3-languages): promote to GA, deprecate v2/languages and v2/glossary-language-pairs#334
daniel-jones-dev wants to merge 1 commit intov3-langs/ga-cross-referencesfrom
v3-langs/ga-phase-2

Conversation

@daniel-jones-dev
Copy link
Copy Markdown
Member

Summary

Stacked on #333#332. Promotes v3/languages to general availability and deprecates the v2 endpoints it replaces.

GA promotion:

  • Remove BETA tags and notices from all v3/languages MDX pages and frontmatter
  • Restructure Languages nav: v3 pages are now primary (no tag); v2 moved into a DEPRECATED subgroup matching the existing pattern for v2 glossaries
  • Update changelog title/description to drop beta framing

Deprecations:

  • GET /v2/languages: deprecated: true in OpenAPI spec, Warning box on overview and auto-generated reference page, title updated to indicate v2
  • GET /v2/glossary-language-pairs: deprecated: true in OpenAPI spec, note added to v2 glossaries overview
  • Also fixes pre-existing duplicate operationId: getLanguages — v2 renamed to getLanguagesV2

Release notes:

  • New May 5 entry covering all GA changes and deprecations
  • Removed v3/languages from "In active development" list

Test plan

  • Languages nav shows v3 pages at top level (no BETA badge), v2 under DEPRECATED subgroup
  • v3/languages overview has no BETA tag or warning box
  • v2/languages overview shows Warning deprecation notice
  • /v2/languages and /v2/glossary-language-pairs show as deprecated in OpenAPI playground
  • Release notes entry renders correctly for May 5
  • Run mint broken-links --check-anchors

🤖 Generated with Claude Code

@daniel-jones-dev daniel-jones-dev force-pushed the v3-langs/ga-cross-references branch from 415fa0e to 7538b22 Compare May 3, 2026 10:12
@daniel-jones-dev daniel-jones-dev force-pushed the v3-langs/ga-cross-references branch from 7538b22 to 4048fc5 Compare May 3, 2026 10:32
@daniel-jones-dev daniel-jones-dev force-pushed the v3-langs/ga-cross-references branch from 4048fc5 to 981d79f Compare May 3, 2026 10:56
@daniel-jones-dev daniel-jones-dev force-pushed the v3-langs/ga-cross-references branch from 981d79f to 51b2ce6 Compare May 3, 2026 11:12
@daniel-jones-dev daniel-jones-dev force-pushed the v3-langs/ga-cross-references branch from 51b2ce6 to 3bd5acf Compare May 3, 2026 15:14
…sary-language-pairs

- Remove BETA tags and notices from all v3/languages docs
- Restructure Languages nav: v3 pages promoted to primary, v2 moved to DEPRECATED subgroup
- Add deprecated: true to GET /v2/languages and GET /v2/glossary-language-pairs in OpenAPI spec
- Fix duplicate operationId: rename v2/languages operationId to getLanguagesV2
- Add deprecation Warning to v2/languages overview and auto-generated reference page
- Add deprecation note to v2 glossaries overview for /v2/glossary-language-pairs
- Add May 5 release notes entry covering all GA changes and deprecations
- Remove v3/languages from "In active development" list

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@daniel-jones-dev daniel-jones-dev marked this pull request as draft May 4, 2026 12:38
@daniel-jones-dev daniel-jones-dev deleted the branch v3-langs/ga-cross-references May 5, 2026 19:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant